Document the .NET Framework 4.5 SubsystemVersion retargeting change for Windows Forms#54553
Open
Copilot wants to merge 8 commits into
Open
Document the .NET Framework 4.5 SubsystemVersion retargeting change for Windows Forms#54553Copilot wants to merge 8 commits into
SubsystemVersion retargeting change for Windows Forms#54553Copilot wants to merge 8 commits into
Conversation
Copilot
AI
changed the title
[WIP] Add missing documentation for SubsystemVersion change
Document the .NET Framework 4.5 Jun 26, 2026
SubsystemVersion retargeting change for Windows Forms
adegeo
reviewed
Jun 26, 2026
adegeo
reviewed
Jun 26, 2026
Co-authored-by: Andy (Steve) De George <67293991+adegeo@users.noreply.github.com>
adegeo
reviewed
Jun 26, 2026
adegeo
approved these changes
Jun 26, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR fills a gap in the .NET Framework 4.5 retargeting guide by documenting that MSBuild changes the default SubsystemVersion from 4.00 to 6.00, which can affect Windows Forms layout when apps rely on SystemInformation or other GetSystemMetrics-derived values.
Changes:
- Added a new Windows Forms retargeting include that explains the
SubsystemVersiondefault change and a workaround. - Inserted the new include into the .NET Framework 4.5 section of the retargeting guide.
- Added
ai-usage: ai-assistedfrontmatter to the edited article.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| includes/migration-guide/retargeting/winforms/subsystemversion-defaults-to-600.md | New include documenting the SubsystemVersion default change, impact, and workaround. |
| docs/framework/migration-guide/retargeting/4.5.x.md | Adds ai-usage metadata and includes the new Windows Forms retargeting entry. |
| </PropertyGroup> | ||
| ``` | ||
|
|
||
| You can also use the [SubsystemVersion compiler option for C#](/dotnet/csharp/language-reference/compiler-options/advanced#subsystemversion) or the [SubsystemVersion compiler option for Visual Basic](/dotnet/visual-basic/reference/command-line-compiler/subsystemversion). |
Comment on lines
+26
to
+30
| | Name | Value | | ||
| | ------- | ----------- | | ||
| | Scope | Minor | | ||
| | Version | 4.5 | | ||
| | Type | Retargeting | |
gewarren
approved these changes
Jun 26, 2026
gewarren
left a comment
gewarren
left a comment
Collaborator
There was a problem hiding this comment.
I guess it doesn't need a TOC entry?
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The .NET Framework 4.5 retargeting guide didn't mention that MSBuild changes the default
SubsystemVersionfrom4.00to6.00. That omission leaves a gap for Windows Forms apps that calculate layout fromSystemInformationor otherGetSystemMetrics-based values and can see size changes after retargeting.What changed
SubsystemVersiondefault change for .NET Framework 4.5.docs/framework/migration-guide/retargeting/4.5.x.mdunder .NET Framework 4.5 > Windows Forms, immediately after the existing EncoderParameter ctor is obsolete entry.ai-usagefrontmatter to the edited article.What the new guidance covers
SubsystemVersionchanges from4.00to6.00when you retarget to .NET Framework 4.5 and build with MSBuild.Workaround example
Internal previews